<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <title></title>
  </head>

  <body>
    <!-- <ul>
		{dede:arclist typeid="1" row="6"}
		<li>[field:title function="cn_substr(@me, 63)" /]</li>
		{/dede:arclist}
	</ul> -->

    <!-- dede cms -->
    <script>
      /*
			Restful API		是一种互联网软件架构的设计规范、设计指南、设计风格、设计原则
			
			1、API	Application Programming Interface		应用程序接口（接口）
			2、Rest	Resource Representational State Transfer	
				apache

			1、Resource
				资源 
				URI:统一资源标识符。是一个字符串。用来标识互联网资源的名称
				URL:统一资源定位符。它是一种具体的URI
			2、Representational
				表现层
				文本	text\html\xml\json\二进制
			3、State Transfer
				状态转化

			Restful API具体设计规范
				1、协议
					HTTPS
				2、域名
					https://api.kaivon.com
					https://wwww.kaivon.com/api/
				3、版本
					https://api.kaivon.com/v1
				4、路径
					https://api.kaivon.com/v1/blogs
				5、方法
					1、GET	获取资源
						GET	https://api.kaivon.com/v1/blogs	获取所有的文章
						GET	https://api.kaivon.com/v1/blogs/id	获取到某一篇文章
					2、POST	添加资源
						POST https://api.kaivon.com/v1/blogs	增加一篇文章
					3、PUT		修改资源（客户端需要提供改变后的完整资源）
						POST https://api.kaivon.com/v1/blogs/id	修改某一篇文章
					4、PATCH	更新资源（客户端需要提供改变的属性）
						PATCH https://api.kaivon.com/v1/blogs/id	更新某一篇文章
					5、DELETE	删除资源
						DELETE https://api.kaivon.com/v1/blogs/id	删除某一篇文章
				6、数据过滤
					1、?limit=10	指定返回数据的数量
						GET	https://api.kaivon.com/v1/blogs?limit=10
					2、?offset=10	指定一个偏移量
						GET	https://api.kaivon.com/v1/blogs?offset=10
					3、?page=2&per_page=10	指定第几页，以及每页的数量
						GET	https://api.kaivon.com/v1/blogs?offset=10
					4、?sortby=time&order=arc	指定返回结果按照哪个属性排序，以及排序的方式
						GET	https://api.kaivon.com/v1/blogs?sortby=time&order=arc
				7、状态码
				8、返回结果
					1、GET		资源对象列表（数组），如果取的是一条数据，那返回一个对象
					2、POST		返回添加后的资源对象，以及有可能会加上是否成功
					3、PUT		返回修改后的资源对象，以及有可能会加上是否成功
					4、PATCH	返回更新后的资源对象，以及有可能会加上是否成功
					5、DELETE	返回空，以及有可能会加上是否成功
				9、返回的数据格式
					尽量使用JSON，避免使用XML

			5、总结
				1、看URL就知道要什么
				2、看HTTP method就知道干什么
				3、看HTTP stuts code就知道结果如何
		 */
    </script>
  </body>
  <html></html>
</html>
